Skip to content

docs: describe Cloud Agent local development constraints - #9166

Draft
mzxchandra wants to merge 1 commit into
mainfrom
cursor/cloud-agent-dev-notes-9176
Draft

mzxchandra wants to merge 1 commit into
mainfrom
cursor/cloud-agent-dev-notes-9176

Conversation

@mzxchandra

Copy link
Copy Markdown
Contributor

Summary

Documents how to run Sim on a Cloud Agent VM: Node 24 must come before /exec-daemon/node, Postgres 17 and Redis are started without systemd, and the app should use bun run dev:full:capped so the Next.js heap does not exhaust a 16GB machine.

Fixes #(issue)

Product update (if relevant)

Future Cloud Agents get the local-dev constraints in CLAUDE.md (AGENTS.md is a symlink to that file). No product behavior change.

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation
  • Other: ___________

Testing

Verified on a Cloud Agent VM: install script ran twice, the start script brought Next.js (/signup 200) and realtime (/health 200) up, browser signup created a workspace, and POST /api/workflows created a workflow named Hello. bun run --cwd apps/realtime type-check passed, and bun run --cwd packages/logger test passed (23 tests). Draft environment build bld-20261017-280df879-fed1-4066-b520-114fe084e013 succeeded.

Checklist

  • Code follows project style guidelines
  • Self-reviewed my changes
  • Tests added/updated and passing
  • No new warnings introduced
  • I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

Screenshots/Videos

Open in Web Open in Cursor 

Record the Node 24 PATH override, host Postgres and Redis startup, and the capped dev server so later agents do not boot the uncapped Next.js heap on this VM.
@vercel

vercel Bot commented Oct 17, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Oct 17, 2026 4:13am UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview — 91db944c Deployed Oct 17, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants